home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / qread32.zip / SAMPLE.ZIP / SAMPLE2.TXT < prev   
Text File  |  1993-12-23  |  23KB  |  407 lines
  1.       --------------------------------------------------------------------
  2.                              QReader Revision History
  3.       --------------------------------------------------------------------
  4.  
  5.            QReader  (C) Copyright 1991-1993  Yandell Computer Services
  6.  
  7.         This file describes the new features in recent QReader releases.
  8.  
  9.         Please refer to QREADER.DOC for a basic description of QReader.
  10.  
  11.   --------------------------------------------------------------------------
  12.   [ QReader 3.2 New Features 12-23-93 ]-------------------------------------
  13.   --------------------------------------------------------------------------
  14.  
  15.   * In  QReader's  Full-Screen-Reader, pressing (Enter) is now the  same  as
  16.     as pressing the PageDown cursor key (or "3" in "NumLock" mode).
  17.  
  18.   * In  the NON-Full-Screen-Reader (Non-FSR), an (E)nd of file  command  has
  19.     been  added.  Non-FSR "End of file" processing (while reading text)  has
  20.     also been greatly enhanced.  The "more" prompt which appears appears  at
  21.     each full page while reading a text file now contains the (E)nd command:
  22.  
  23.        (21% read), (H)elp (F)ind (E)nd (P)gUp (T)op (>), More?
  24.  
  25.     As  always, "(R)epeat"  will only display after the (F)ind command if  a
  26.     successful (F)ind has been executed.
  27.  
  28.     "End of file" prompts now appear when the end of a text file is reached
  29.     in the Non-FSR instead of "more" prompts.  These prompts look like this:
  30.  
  31.       [END OF FILE] (H)elp (P)gUp (T)op (>), (Enter)=quit?
  32.  
  33.     The  above prompt appears when the (E)nd command is executed,  when  the
  34.     end of the file is reached during normal reading,  and when a successful
  35.     (F)ind  or (R)epeat find item is located on the last page (screen) of  a
  36.     text  file.  Note that the (F)ind, (R)epeat, and (E)nd commands are  not
  37.     displayed (or valid) at the "End of file" prompt.
  38.  
  39.       [END OF FILE] (H)elp (>), (Enter)=quit?
  40.  
  41.     The above prompt appears when a text file is displayed that is 23  lines
  42.     or less in total length.  The only option available with short files  is
  43.     to slide them left and right in case they contain long lines of text.
  44.  
  45.   * In  the Non-FSR, when a (F)ind or (R)epeat find is  unsuccessful, QReader
  46.     NO LONGER displays a "Redisplay this file" prompt that returns the caller
  47.     to  top  of the file if it is answered Yes.  QReader will now  display  a
  48.     "Not found, Press (Enter) to continue"  message and the caller's  "place"
  49.     in the file will remain unchanged after an unsuccessful (F)ind/(R)epeat.
  50.  
  51.   * The Non-FSR will now accept cursor key input, just like the Full-Screen-
  52.     Reader does.  The Sysop may use them locally, and callers must have  the
  53.     Doorway  mode of their terminal program activated to use cursor keys  or
  54.     their "NumLock" on to use the cursor-pad equivalents on the number  pad.
  55.     The  cursor  keys simply match their counter-part which appears  in  the
  56.     Non-FSR prompt:  PageDown = (Enter),  PageUp = (P)ageUp, etc.
  57.  
  58.   * QReader now has a "lite" mode, which bypasses the QReader main menu  and
  59.     goes straight to a text selection screen. This is a limited use mode and
  60.     should  only be used in special circumstances, since most  of  QReader's
  61.     features  will not be available.  All of the QReader main menu  commands
  62.     will  be unavailable in this mode.  To run text configurations  in  this
  63.     mode, simply enter NONE as the MENU NAME in the text configuration  file
  64.     using the QRSETUP program.
  65.  
  66.   * QReader now contains an internal ANSI emulator for those folks who still
  67.     use the old fashioned "one ASCII file for mono, one ANSI file for color"
  68.     method for menu, hello, help, etc. files.  While ANSI.SYS has never been
  69.     needed  by the Sysop to utilize QReader's Full_Screen_Reader or  any  of
  70.     the menus, etc. done with color macros, it was needed if the menus, etc.
  71.     were ANSI files (for local display only).
  72.  
  73.   * When editing a display file  (MENU, HELP etc.) from QRSETUP using a text
  74.     or graphic file editor defined in QRSETUP.DEF, QRSETUP will now make the
  75.     default DOS location the same as the location of the display file before
  76.     calling the defined editor.
  77.  
  78.  
  79.  
  80.   --------------------------------------------------------------------------
  81.   [ QReader 3.1 New Features 09-17-93 ]-------------------------------------
  82.   --------------------------------------------------------------------------
  83.   * If you have an earlier version of QReader installed, you must follow the
  84.     directions located in UPGRADE.DOC in order for QReader 3.1 to function.
  85.  
  86.   * QReader  now recognizes the RIP designation in DOOR.SYS files as a valid
  87.     screen mode.  When encountered, QReader will act as if the caller is  in
  88.     regular color mode.
  89.  
  90.   * QReader will detect if the caller is using a RIP capable  communications
  91.     program. If so, QReader will clear the caller's RIP screen and set it to
  92.     25 line  mode.  This is needed for QReader's  'Full Screen Reader' which
  93.     is designed to be used on a 25 line screen.
  94.  
  95.   * The MENU, HELLO, and HELPx files in QREAD31.ZIP have been updated with a
  96.     modern look.  If you are using the default versions of these files  from
  97.     earlier versions of QReader, you might want to give these a try.
  98.  
  99.   * QReader  now allows the use of multi-port hardware (via FOSSIL) on  some
  100.     nodes  and not on others.  QReader 3.0 introduced FOSSIL support  and  a
  101.     single FOSSIL setting in the MAIN configuration file which meant QReader
  102.     used FOSSIL i/o on ALL nodes (if set).  Now you may place a command line
  103.     switch of /NOFOSSIL in QReader door batch files on nodes that do not use
  104.     multi-port FOSSIL communications.  This is only needed on those nodes if
  105.     you answered YES to "Use a FOSSIL driver" in the MAIN configuration.
  106.  
  107.   * In Wildcat mode, QReader will now use the Wildcat environment  variables
  108.     WCBASEID  and WCIRQID for non-standard com ports  (when used).  Previous
  109.     versions of QReader required any non-PCBoard BBS to use QReader specific
  110.     variables called QRBASE and QRIRQ, which are now only needed when  using
  111.     QReader in 'generic DOOR.SYS mode'(BBS type #3 in QRSETUP.EXE).
  112.  
  113.   * SEND.BAT now accepts the modem's locked DTE rate for external  protocols
  114.     that  need it fed implicitly to them.  %7 = locked DTE modem speed.  See
  115.     See QREADER.DOC and SEND.BAT for details.
  116.  
  117.  
  118.  
  119.   --------------------------------------------------------------------------
  120.   [ QReader 3.0 New Features 02-05-93 ]-------------------------------------
  121.   --------------------------------------------------------------------------
  122.  
  123.   * QReader's "non_full_screen_reader" now features "PageUp" and  left-right 
  124.     scroll that are similar to the capabilities of the "full_screen_reader".  
  125.  
  126.     - The command to PageUp in the non_full_screen mode is "P" (for  PageUp) 
  127.       and is available at the "More?" prompt while reading text. 
  128.  
  129.     - The commands to scroll the screen left and right for text longer  than  
  130.       79 characters are "<" and ">"  and are available at the "More?" prompt 
  131.       while reading text in the non_full_screen_reader.
  132.  
  133.   * FOSSIL  driver support added.  If your BBS uses a FOSSIL driver  you may
  134.     now have QReader use the FOSSIL driver also.  You may also need  to  use
  135.     this  feature if your BBS software supports Multi-port serial cards  and
  136.     permits FOSSIL redirection to these cards through the use of special TSR
  137.     software.  To enable FOSSIL communications, run  QRSETUP.EXE and  select  
  138.     option #1 to edit the MAIN configuration file.  Answer the question "Use 
  139.     a FOSSIL?" with a Y for YES.
  140.  
  141.   * Added support for extended IRQ use (above IRQ 7).  Previous versions  of 
  142.     QReader provided non-standard COM support with IRQ 1 through 7.  The IRQ 
  143.     value may now be 1 thru 15. This is handled automatically in the PCBoard 
  144.     mode.  In the Wildcat and DOOR.SYS modes, the environment variables must
  145.     be set as outlined in QREADER.DOC for nodes using non-standard ports.
  146.  
  147.   * The enclosed QRFSHELP (without cursor arrow characters) should be  used.
  148.     Some  communications programs do not correctly handle  these  characters 
  149.     when  displaying them to the remote caller.  QRFSHELP is located in  the 
  150.     QReader directory with QREADER.EXE.
  151.          
  152.   * The 'text file number' may now be selected from QReader's main menu. The 
  153.     numbers from the "text file menu' may now be placed on the QReader  main 
  154.     menu  if desired, bypassing the need to press "R" and then  viewing  the 
  155.     'text file menu'. This is particularly helpful in QReader configurations 
  156.     where there are only 2 or 3 text files installed.
  157.  
  158.   * Several configuration parameters such as the BBS name, the  registration
  159.     number, the type of BBS software, etc. have been moved from each of  the
  160.     separate  text  configuration  (.CNF) files to one  "MAIN"  file  called
  161.     QREADER.@@@.  This file will be created automatically when following the
  162.     upgrade instructions in UPGRADE.DOC or when installing QReader  for  the
  163.     first time. It is edited with QRSETUP by selecting the QRSETUP main menu
  164.     option #1.
  165.  
  166.   * A 'Fast Load' option has been added.  It speeds up the loading of larger 
  167.     configurations, either when initially loaded or when (S)elected from the 
  168.     QReader main menu.  "Larger configurations" would be those which contain 
  169.     100  or  more individual text files.  This parameter is set in  the  new 
  170.     QRSETUP MAIN configuration screen (see the above paragraph).
  171.    -NOTE: Use of the new Fast Load option disables the @FILEDATE@ macro  and 
  172.     @FILEDATEx@  macros.   This is how the faster loading  is  obtained,  as 
  173.     QReader  will  not check every text file's date (while it is  loading  a 
  174.     configuration)  to determine the value of these macros.  See QREADER.DOC 
  175.     for a description of these macros. 
  176.  
  177.   * Added  the  ability to read the PCBDOOR environment variable  passed  by 
  178.     PCBoard. This will be read ONLY if the door being opened is opened  with 
  179.     SELECT.CNF  in  the door batch file command line.  For example,  if  the 
  180.     caller enters: QREADER USA  at the PCBoard prompt and the batch file for 
  181.     QReader  is QREADER.EXE SELECT.CNF etc.,  QREADER will immediately  load 
  182.     the USA.CNF configuration (the .CNF extension is automatically  loaded). 
  183.     The reason for the necessity of SELECT.CNF is:  If the caller's "command   
  184.     line  parm" (i.e. USA) does not exist, or if the caller  does  not  have   
  185.     security  for the "Security to select" setting, the SELECT menu will  be   
  186.     displayed instead.  If you run PCBoard and do not wish QReader to behave
  187.     in this manner, place /NOPCBDOOR in the QReader command line.
  188.  
  189.   * All  finds are now highlighted in the non_full_screen_reader (if  caller 
  190.     is in color mode).
  191.  
  192.   * All finds in a single line are now highlighted in the full_screen_reader 
  193.     (color mode only).
  194.  
  195.   * Removed  underlined finds in both readers when in non-color  mode.  When 
  196.     text is found in non-color mode it will be capitalized.  Arrows will  be
  197.     displayed on the right of the line with found text (if room permits).
  198.  
  199.   * Files  shorter than 20 lines in length were not displaying  properly  in 
  200.     the full_screen_reader.  This has been corrected.
  201.  
  202.   * By  popular request, the QReader title which appears at the top  of  the 
  203.     full-screen_reader  pop-up help window has been changed to a solid  line 
  204.     and contains no text.
  205.  
  206.   * The QRSETUP install program which came with version 2.0 was not allowing 
  207.     security levels higher than 255 to be entered.  This is the maximum  for 
  208.     PCBoard  and was fine for QReader 1.0, but not with QReader 2.0 and  the 
  209.     additional BBS types now supported.
  210.  
  211.   * Added support to calculate QReader download times for newer  (yet lesser 
  212.     used) connect rates such as 12000 (twelve-thousand). Earlier versions of 
  213.     QReader  expected standard connect rates,  such as  (300,1200,2400,4800, 
  214.     9600,14400,19200)  for  calculating download times, and an  error  would 
  215.     occur if a download was attempted under other circumstances.
  216.  
  217.   * While earlier versions of QReader were DESQview aware and behaved,  some 
  218.     performance degradation was discovered when using "virtualized"  screens  
  219.     with  DESQview-386.  QReader's performance is now improved  under  these 
  220.     conditions.
  221.  
  222.   * The parameters passed to SEND.BAT for downloading with the  DSZ  "portx"
  223.     option for non-standard COM ports are now passed properly.
  224.  
  225.   * If using PCBoard and logging caller log entries to a printer,  QReader's 
  226.     printer routines have been made more generic.
  227.  
  228.   * Three command line parameters have been added.  These are not likely  to 
  229.     be  needed by most Sysops, but if you need them, you REALLY  need  them. 
  230.     Adding  them  to  configuration file is not planned  since  they  should 
  231.     rarely be used:
  232.  
  233.         /NOBEEP  -  QReader  follows the local alarm (beep) setting found in
  234.         any  door information files which provide it. If you have  your  BBS 
  235.         software set to beep LOCALLY at caller input errors, etc. but you do  
  236.         not want QReader  to beep at similar events, add this to the command
  237.         command line as shown below.
  238.  
  239.         /NOCALLER  -  QReader  writes  appropriate entries  to  the  current
  240.         node's caller file or activity log (PCBoard and Wildcat modes only). 
  241.         Please  see  QREADER.DOC for a complete list of entries.  If you  do
  242.         not want QReader  to echo these events to the log files, add this to
  243.         the the QREADER.EXE command line as shown below.
  244.  
  245.         /NOLPT  -  QReader  follows  the printer toggle in PCBoard.  If  you
  246.         do not want QReader to also echo caller log activity to the printer,
  247.         add this to the QREADER.EXE command line as shown below.
  248.  
  249.         To add any of these toggles, edit the QReader door batch file(s)  as 
  250.         shown:
  251.  
  252.         QREADER.EXE  SELECT.CNF  D:\PCB\  /NOLPT /NOBEEP /NOCALLER
  253.  
  254.         All  three are shown in the example above for illustration  purposes 
  255.         only.  You  may enter one, two, or all three of them, in  any  order 
  256.         desired. Again, it is  recommended to use these toggles only if they 
  257.         are REALLY needed.
  258.  
  259.  
  260.  
  261.   --------------------------------------------------------------------------
  262.   [ QReader 2.0 New Features 01-24-92 ]-------------------------------------
  263.   --------------------------------------------------------------------------
  264.  
  265.   * NEW (Z)ippy search command for extremely FAST text searches in files.
  266.      - After selecting (Z), caller will be asked for the text to search for.
  267.      - Caller will then be prompted where (which items) to search, and  they 
  268.        may choose (L)ist (show the text selection menu) at this prompt.
  269.      - The  caller may enter any of the items by number, such as 1 2  3,  or 
  270.        enter (A) to Zippy search ALL of the text files in the configuration.
  271.      - If the text is found, the line containing the text is displayed.  The 
  272.        caller  may  then press (Enter) to display the file,  (C)ontinue  the 
  273.        search  in the current item, (S)kip the current item and  resume  the 
  274.        search in the next item selected, or stop the search.
  275.      - If the caller presses enter to display the found text, the item  will 
  276.        be  displayed starting with the ENTIRE page that contains  the  found 
  277.        text, with the found text highlighted or underlined in the middle  of 
  278.        the screen!
  279.      - If  the  caller displays an item after a Zippy find, then  quits  the 
  280.        display,  and  if there are more items in the Zippy search "cue", the 
  281.        caller  may opt to continue the Zippy search in the remaining  items.  
  282.        However, if the caller displays during a Zippy search, then (S)elects 
  283.        a  different  item while viewing the first, it is assumed  the  Zippy 
  284.        chain  is  no  longer desired and the caller will  not  be  asked  to 
  285.        continue the Zippy scan, even if there would have been items left  in 
  286.        the Zippy "cue".
  287.  
  288.   * The  new  (Z)ippy  search  command supports up  to  three  boolean  [OR] 
  289.     separators per search field.  The separator is the | key.  For example:
  290.    
  291.          Text to search for? (USR | HAYES |  MODEM    )
  292.    
  293.     would search for USR or Hayes or Modem in the text items selected.
  294.  
  295.   * NEW ability to place nested SELECT???.DAT type files in SELECT.DAT. This 
  296.     allows  unlimited branching to different selection menus  for  different 
  297.     categories  of text file configurations.  QREADER.DOC contains  examples 
  298.     and instructions for using this feature.
  299.  
  300.   * QReader  1.0  allowed 99 text files in each  configuration's  text  data 
  301.    (.DAT) file.  This has been increased to 500 files per configuration.
  302.           
  303.   * QReader is now compatible with these three BBS environments:
  304.     (1) PCBoard 14.5x
  305.     (2) Wildcat 3.x
  306.     (3) "generic" DOOR.SYS
  307.  
  308.   * NEW Wildcat 3.x support:
  309.     - Updates Wildcat ACTIVITY.### logs with QReader activity!
  310.     - Updates user's record with regard to download counts, bytes, and  time 
  311.       as per Sysop's choice.
  312.     - Follows "Allow (G)oodbye" setting (allows callers to say (G)oodbye and
  313.       log-off while in QReader).
  314.     - Wildcat color macros may be used in text files.
  315.           
  316.   * Added  an INTERNAL editor for editing text .DAT configuration  files  in 
  317.     QRSETUP.  In version 1.0 these had to be edited with a text editor.
  318.  
  319.   * QReader text data (.DAT) configuration files may contain two  additional 
  320.     fields for each text item.
  321.     - One field is a short description of the particular text item.  This is 
  322.       displayed when doing a Zippy scan. If USA Today is being searched:
  323.  
  324.       Searching Item (1) Advertising
  325.       Searching Item (2) Banking and Economy
  326.       Searching Item (3) Bonus Section
  327.       etc...
  328.  
  329.     - The second new field is a very short "notes" field which is only  used 
  330.       by  the Sysop to place a small note about a particular item.  This  is 
  331.       never displayed anywhere other than in the QRSETUP .DAT file editor.
  332.       NOTE: it is NOT mandatory to update version 1.0 text data (.DAT  files 
  333.       to the new format.
  334.  
  335.   * Text  files installed in a configuration's text .DAT data file  may  now 
  336.     contain  a path. While it is recommended that all files in a  particular 
  337.     configuration be located in the location specified for them in  QRSETUP, 
  338.     this ability allows more flexibility if needed. If a file in a .DAT file 
  339.     contains a path, the "location of text items" parameter in QRSETUP  will 
  340.     not be used for THAT particular file.
  341.  
  342.   * Added multi-language file capability. This applies for every displayable 
  343.     file used by QReader, unless an extension is specified for the file in a 
  344.     QReader configuration or data file. PCBoard mode only.
  345.  
  346.   * QReader supports "security specific" files. If a MENU file  specifically 
  347.     for level 90 callers is desired, create a file called MENU90 (MENU90G if 
  348.     using the ANSI "two file" method).
  349.  
  350.   * Added support for nodes greater than 99 in the new PCBoard /X software.
  351.  
  352.   * NEW  "free download" toggle added to QRSETUP which allows  each  QReader 
  353.     configuration to be installed differently if needed (PCBoard and Wildcat
  354.     modes only).  Download Settings are:
  355.     (0) Charge caller d/l count, bytes, and d/l time.
  356.     (1) Charge caller for d/l time, do not charge d/l count or bytes.
  357.     (2) Do not charge caller for d/l count, bytes or time.
  358.     (3) Charge caller d/l count and bytes, do not charge for d/l time.
  359.           
  360.     QReader  1.0 followed PCBoard's FSEC and PWRD for determining if a  file 
  361.     was downloadable a caller. The above new toggle replaces this method and 
  362.     adds much more flexibility between different QReader configurations.
  363.                          
  364.   * Added support for Non-DSZ - DSZLOG compatible protocols. QReader is  now 
  365.     more flexible when reading DSZLOG files from protocols other than DSZ.
  366.  
  367.   * New parameter in PROTOCOL.DAT allows placement of  QReader  status  line 
  368.     during transfers. For each protocol choice the Sysop may select  whether 
  369.     to place the  QReader status line at the Top or  Bottom  of  the  screen 
  370.     depending on what works best with the protocol selected.  For  instance, 
  371.     DSZ works best with the door status line at the top of the screen, where 
  372.     its  graphical counterpart GSZ works best with the door status  line  at 
  373.     the bottom of the screen.
  374.  
  375.   *  SEND.BAT now accepts non-standard com port parameters from QReader  for 
  376.      use with DSZ or GSZ:
  377.         %5 = base address (hex) for com port (use with DSZ portx option).
  378.         %6 = IRQ for com port (use with DSZ portx option).
  379.      See QREADER.DOC and SEND.BAT for details.
  380.  
  381.  
  382.   NOTE: The rest of the version 2.0 enhancements below deal with the display
  383.   text files used by QReader: MENU, HELLO, HELP, SELECT, etc...
  384.  
  385.   * Added support for Wildcat 3.x color macros in text files.  QReader  will
  386.     automatically use either PCBoard or Wildcat color macros when either are 
  387.     found. The text files contained in QREAD20.ZIP use PCBoard color macros.  
  388.     Run  USB-CONV.EXE to convert the enclosed PCBoard color macro  files  to 
  389.     Wildcat macros if you wish to use them instead.
  390.  
  391.   * The ANSI text file handler has been greatly improved. Sysops who are not 
  392.     familiar with (or not wanting to use) the PCBoard or Wildcat color macro 
  393.     type files now have more flexibility with the plain Ascii and ANSI  "two 
  394.     file"  method.  Run USB-CONV.EXE to convert the enclosed  PCBoard  macro 
  395.     files to Ascii\ANSI files if color macro files are not desired. 
  396.  
  397.   * In QReader 1.0, some Sysops had difficulty editing the multi-paged  text 
  398.     files such as HELP.  QReader now supports the linking of files together, 
  399.     by specifying the "next" filename in the file currently being displayed.  
  400.     This  is  done by placing a "%" (percent) in the LEFT-MOST  (column  #1) 
  401.     position of the 24th line of the current file. The % must IMMEDIATELY be 
  402.     followed  by  the filename you wish QReader to append, such  as  %HELP2. 
  403.     This allows the Sysop to edit each page separately. See QREADER.DOC  for 
  404.     complete details and instructions.
  405.  
  406.  
  407.